home *** CD-ROM | disk | FTP | other *** search
/ PC Media 3 / PC MEDIA CD03.iso / share / udos / m_mem293 / mousemen.doc < prev    next >
Encoding:
Text File  |  1992-10-23  |  35.3 KB  |  853 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                            MOUSEMENU USER'S MANUAL
  9.  
  10.  
  11.                               (Version 2.9.3)
  12.  
  13.                                     by
  14.  
  15.  
  16.                                David R. Webb
  17.  
  18.                              October 24, 1992
  19.  
  20.  
  21.  
  22.                              Table of Contents
  23.  
  24.  
  25.      1    Introduction. . . . . . . . . . . . . . . . . . . . . . .  1
  26.  
  27.           1.1  Shareware -- What is it, Anyway? . . . . . . . . . .  2
  28.  
  29.           1.2  Computer Requirements. . . . . . . . . . . . . . . .  3
  30.  
  31.           1.3  Running MouseMenu. . . . . . . . . . . . . . . . . .  4
  32.  
  33.      2    Updating the Data File. . . . . . . . . . . . . . . . . .  6
  34.  
  35.           2.1  Creating Menu Headings and Batch Files . . . . . . .  6
  36.  
  37.           2.2  Inserting a New Heading. . . . . . . . . . . . . . .  7
  38.  
  39.           2.3  Deleting a Heading . . . . . . . . . . . . . . . . .  7
  40.  
  41.           2.4  Moving a Heading . . . . . . . . . . . . . . . . . .  8
  42.  
  43.           2.5  Creating a New Page. . . . . . . . . . . . . . . . .  8
  44.  
  45.           2.6  Passing Parameters . . . . . . . . . . . . . . . . .  8
  46.  
  47.           2.7  Changing Screen Colors . . . . . . . . . . . . . . .  9
  48.  
  49.           2.8  Titling a Page . . . . . . . . . . . . . . . . . . .  9
  50.  
  51.           2.9  Changing Screen Saver Time . . . . . . . . . . . . .  9
  52.  
  53.           2.10 Invoking the "Moths" Screen Saver. . . . . . . . . .  9
  54.  
  55.      3    Advanced SETUP Information (DAT File Specifics) . . . . . 10
  56.  
  57.      4    Expanding MouseMenu . . . . . . . . . . . . . . . . . . . 12
  58.  
  59.      5    Known Problems. . . . . . . . . . . . . . . . . . . . . . 12
  60.  
  61.      6    Summary . . . . . . . . . . . . . . . . . . . . . . . . . 13
  62.  
  63.      INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  64.  
  65.      ORDER FORM . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  66.  
  67.  
  68.  
  69.                               MouseMenu 2.9.3
  70.  
  71.      1    Introduction
  72.  
  73.      MouseMenu is a MicroSoft compatible mouse (as well as cursor-key)
  74.      driven menu system for all IBM PC's and PC clone machines. It
  75.      allows the user instant access to 128 user-defined batch files, if
  76.      used in its purest form, and an unlimited number of batch files, if
  77.      used on a directory-by-directory basis.
  78.  
  79.      MOUSEMENU IS SHAREWARE.  While you can distribute Shareware to
  80.      anyone, you can only use it free for 30 days.  After that, if you
  81.      want to keep on using it, you need to register the software.  To do
  82.      that, fill out the form at the end of this document and send it
  83.      along with the registration fee to the address listed.  The fee is
  84.      only $5.00 (not much more than a good paperback book), so don't worry
  85.      about that!  MouseMenu can be freely distributed to ANYONE who wishes
  86.      to use it.  If the user has any problems or suggestions to make,
  87.      he or she should be send them to the following address:
  88.  
  89.                David R. Webb
  90.                P.O. Box 17
  91.                Kaysville, Utah  84037-0017
  92.  
  93.      If a registered user makes any suggestions for improvement/bug-
  94.      fixes that are used in future versions of MouseMenu, the user will
  95.      receive that update FREE!  So, please send a card or letter to the
  96.      above address if you have ANY problems or suggestions concerning
  97.      the program.  (You may also contact the author on America Online
  98.      using the screen name DaveRWebb, on Prodigy using the ID
  99.      KNGP41A, or on INTERNET using address "DaveRWebb@aol.com".)
  100.  
  101.      Upon distribution, this software was virus-free and will hopefully
  102.      remain so, but that cannot be guaranteed.  The programmer is
  103.      therefore not responsible for any hardware or software damages to
  104.      a user's system as a result of using MOUSEMENU.  To keep the
  105.      program as pure as possible, please do not alter the original code
  106.      in any way.
  107.  
  108.      The user should receive the following files with the MouseMenu
  109.      package:
  110.  
  111.      1)   MOUSEMEN.BAT--The batch file that starts everything.If you did
  112.           not receive this file, create the following file (named
  113.           "MouseMen.Bat"):
  114.  
  115.                echo off
  116.                cls
  117.                MouseRun
  118.                MouseTmp
  119.  
  120.  
  121.                                             1
  122.  
  123.  
  124.  
  125.           (If you have DOS 3.30 or later, then enter:
  126.  
  127.                @echo off
  128.                MouseRun
  129.                MouseTmp
  130.  
  131.           Or copy Mouse3_3.Bat to MouseMen.Bat if you received these
  132.           files in your package.)
  133.  
  134.      2)   MOUSEMEN.DAT--The data file which MouseMenu uses.  If you did
  135.           not receive this file, don't worry--it will be created for
  136.           you.  See the upcoming section titled "Updating the Data
  137.           File."
  138.  
  139.      3)   MOUSERUN.EXE--The program which does it all.  THIS FILE MUST
  140.           BE INCLUDED IN THE MOUSEMENU PACKAGE.  IF IT IS NOT PRESENT,
  141.           MOUSEMENU WILL NOT RUN!
  142.  
  143.      4)   HOME.BAT--A very helpful batch file.  If you place all of your
  144.           MouseMenu files in a subdirectory called MOUSEMEN, then place
  145.           MOUSEMEN in your directory PATH, typing "Home" from anywhere
  146.           will instantly take you back to your menu!
  147.  
  148.      5)   READ_ME.1ST--A simple explanation of how to start MouseMenu,
  149.           since MouseMenu is very easy to run.
  150.  
  151.      6)   MOUSEMEN.DOC--A text-only version of this document.
  152.  
  153.  
  154.  
  155.      1.1  Shareware -- What is it, Anyway?
  156.  
  157.      Shareware programs are circulated by various means, bulletin boards
  158.      and shareware distributors being the most common.  They are low-
  159.      cost, reliable pieces of software that you may run on your computer
  160.      before you buy them, to see if they meet your needs.  This is much
  161.      more preferable to buying the software from a vendor only to find
  162.      out that it doesn't do what you wanted it to.  Most software
  163.      vendors will not allow the return of software, unless your disks
  164.      are damaged, and then they'll only replace the disks.  No refunds.
  165.  
  166.      With a piece of Shareware (like MouseMenu 2.9.3), you're allowed to
  167.      actually use the fully-functioning program itself for 30 days
  168.      without a charge!  The version of MouseMenu you're looking at now
  169.      is the actual software - not a demo.  If a Shareware program does
  170.      not meet your needs, you're free to get rid of it -- preferably by
  171.      giving it to someone else to look at.  There is no charge if you
  172.      don't like the product.  However, if you do like a Shareware
  173.      product (and you will), then the author asks for you to register it
  174.      with him or her.  Shareware registration can cost anywhere from
  175.      $5.00 up to $100.00, depending on what the author thinks the
  176.      program is worth.  (MouseMenu is on the low end of the scale -- it
  177.  
  178.  
  179.                                             2
  180.  
  181.  
  182.  
  183.      only costs $5.00 for a single-user license.)  In almost all cases,
  184.      the registration fee is much, much cheaper than buying a commercial
  185.      program of the same quality.  (After a little research, you can
  186.      find several menu programs of equal quality at your local software
  187.      store -- for FOUR TIMES the cost of MouseMenu.)
  188.  
  189.      SHAREWARE IS NOT FREE!  Although previous versions of MouseMenu
  190.      were what is called FREEWARE, as of version 2.9.3 it has become
  191.      Shareware.  Why?  Because I simply can't put all the work, time,
  192.      and money into developing a better product without some monetary
  193.      support.  If the users of MouseMenu do not register, then I will
  194.      probably not be able to release future versions of the product.
  195.      (As an aside:  I'm already Alpha-Testing MouseMenu 3.0 and it's
  196.      going to be awesome -- the best gets better!)  I encourage you to
  197.      support shareware, not only MouseMenu, but other products as well;
  198.      the authors provide good, quality products for very reasonable
  199.      prices.  (If you don't believe me, go down to your local software
  200.      store and price software!)
  201.  
  202.      To register MouseMenu, just fill out the form on the last page of
  203.      this manual, or print out the form that comes with the MouseMenu
  204.      package.  Send your check or money order, along with the form, to
  205.      the address given.  When you register, you'll automatically receive
  206.      the following:
  207.  
  208.           1)   A free newsletter announcing new MouseMenu updates.
  209.  
  210.           2)   A 50% discount on MouseMenu Upgrades!
  211.  
  212.           3)   A disk with the most recent version of MouseMenu if you
  213.                register with an older version.
  214.  
  215.      As you can see, it's well worth the money.  But, because it's
  216.      Shareware, you can decide that for yourself.  If you find that
  217.      you're using MouseMenu consistently after the first 30 day trial
  218.      period, I encourage you to register with me to get the full
  219.      benefits from the software.
  220.  
  221.  
  222.  
  223.      1.2  Computer Requirements
  224.  
  225.      You can run MouseMenu on any PC, XT, or AT-type machine.  The only
  226.      requirements are 256K of memory and DOS 2.X or higher.  (Please,
  227.      try MouseMenu thoroughly on your particular system before you
  228.      decide to register it!)
  229.  
  230.                                             3
  231.  
  232.  
  233.  
  234.      1.3  Running MouseMenu
  235.  
  236.      You must run MouseMenu from its batch file MOUSEMEN.BAT.
  237.  
  238.      (NOTE:    You may rename MOUSEMEN.BAT to any file name you wish
  239.                with a ".BAT" extension.  Many people prefer MM.BAT,
  240.                since MM is quicker and easier to type than MOUSEMEN.
  241.                You may also use the provided HOME.BAT file which will be
  242.                discussed later.)
  243.  
  244.      MOUSEMEN.BAT does the following:
  245.  
  246.      1)   Run the MOUSERUN program, which puts the menu on the screen,
  247.           awaits the user's selection, and generates the appropriate
  248.           batch file to execute that selection.  It then saves this
  249.           temporary batch file to disk as "MouseTmp.Bat."
  250.  
  251.      2)   Starts the MOUSETMP batch file which executes the user's menu
  252.           selection.
  253.  
  254.      Once you have run the MOUSEMEN batch file (either from the keyboard
  255.      or from AUTOEXEC.BAT) you should get a screen that looks a little
  256.      like the following:
  257.  
  258.      ┌───────────────────────────────────────────────────────────────┐
  259.      │ F1-HELP  F2 - INFO  F3 -SETUP  F4-DOS SHELL  Esc-Exit to DOS  │
  260.      │ ╔══════════════════════════════════════════════════════════╗  │
  261.      │ ║                 MouseMenu 2.9.3 Demo Menu                ║  │
  262.      │ ╟─────────────────────────────┬────────────────────────────╢  │
  263.      │ ║█A - Read Me First███████████│ B - Look At MOUSEMEN.BAT   ║  │
  264.      │ ║                             │                            ║  │
  265.      │ ║ C - Look at MOUSEMEN.DAT    │ D - Look At Documentation  ║  │
  266.      │ ║                             │                            ║  │
  267.      │ ║ E - Run A DOS Command       │                            ║  │
  268.      │ ║                             │                            ║  │
  269.      │ ║                             │                            ║  │
  270.      │ ║                             │                            ║  │
  271.      │ ║                             │                            ║  │
  272.      │ ║                             │                            ║  │
  273.      │ ║                             │                            ║  │
  274.      │ ╚═════════════════════════════╧════════════════════════════╝  │
  275.      │ ████████████████████████ PAGE 1 OF 1 ███████████████████████  │
  276.      └───────────────────────────────────────────────────────────────┘
  277.  
  278.      (NOTE:    If your screen has none of these headings, skip this
  279.                section and go to the section titled Updating the Data
  280.                File.)
  281.  
  282.      Use the cursor arrow keys to move the selection bar around.  If you
  283.      have a MicroSoft compatible mouse installed, a mouse cursor should
  284.      appear as you move the mouse about.  Click once on any heading to
  285.      move the selection bar to that position.  You may also move the bar
  286.  
  287.  
  288.                                             4
  289.  
  290.  
  291.  
  292.      vertically downward by pressing the space bar.
  293.  
  294.      Execute an option by moving the selection bar to the desired
  295.      position and pressing ENTER, or by moving the mouse cursor to the
  296.      desired heading and clicking twice with the LEFT mouse button (once
  297.      to move the selection bar and once more to execute the selected
  298.      menu item), or by pressing the letter next to the desired
  299.      selection.
  300.  
  301.      If you have more than one page in your menu (you may have up to 8
  302.      pages), use the PgUp and PgDn keys or the RIGHT button on the mouse
  303.      to change the page number.
  304.  
  305.      Press the F1 button from anywhere within MouseMenu and you will see
  306.      a help screen concerning the area of MouseMenu you're in at the
  307.      time.  For example, if you press F1 from the screen shown above,
  308.      you will see a help screen about how to use the Main Menu screen of
  309.      MouseMenu.  If you press F1 from the SETUP screen, you will see a
  310.      help screen about SETUP.  This is true anywhere within MouseMenu.
  311.      Press any key or mouse button to return from any help screen.
  312.      (There is an exception to this rule in the SETUP help screen where
  313.      you are given general information and are then asked if you want
  314.      more specific help.  In that case, the correct answers are "Y" for
  315.      yes, "N" for no, or ESC to quit.)
  316.  
  317.      Pressing the F2 button (or clicking on the F2 display) from the
  318.      Main Menu will give you some information on who may use MouseMenu
  319.      and how to register the product (See Shareware -- What is it
  320.      anyway?).  Press any key or mouse button to return to the Main Menu
  321.      screen from the information screen.
  322.  
  323.      Pressing F3 will put you in SETUP mode.  This allows you to update
  324.      your headings, the associated batch files, your screen colors, the
  325.      title of each page of the menu, the number of seconds until the
  326.      screen saver (blanker) is invoked, and the style of the screen
  327.      blanker (plain blank, or eaten up by "moths").  Press ESC to return
  328.      to the Main Menu from the SETUP screen.  (See Updating the Data
  329.      File.)
  330.  
  331.      Pressing the F4 key will put you in a DOS "shell."  Your screen
  332.      will clear and the message "Type EXIT to return to MouseMenu...."
  333.      will appear along with your normal DOS prompt.  Treat this as you
  334.      would DOS until you're ready to return to MouseMenu.  At that time,
  335.      just type "EXIT" and you'll automatically return to the Main Menu
  336.      screen (no matter which disk or directory you happen to be in at
  337.      the time).  One caution:  don't forget you're in the DOS
  338.      shell--some programs won't have enough memory to run while you're
  339.      in the shell.  Run big programs from MouseMenu's Main Menu instead.
  340.  
  341.      As you can see, MouseMenu is quite simple to operate.  This makes
  342.      it a great help to those who are unfamiliar or uncomfortable with
  343.      DOS.  At this point in time, someone who knows a little about batch
  344.  
  345.  
  346.                                             5
  347.  
  348.  
  349.  
  350.      files must "set up" the menu for the novice user.  The next release
  351.      of MouseMenu (version 3.0) will include an automatic heading
  352.      generation feature.
  353.  
  354.  
  355.      2    Updating the Data File
  356.  
  357.      MouseMenu stores all of the information it needs for the user's
  358.      heading names, batch files, colors, etc. in a file named
  359.      MOUSEMEN.DAT.  This is a simple ASCII text file that you can type
  360.      out and look at, if you desire.  Although it is not necessary to do
  361.      so, you may also use your favorite text editor to update the DAT
  362.      file.  However, MouseMenu has its own built in procedures to take
  363.      care of this process.
  364.  
  365.      If your Menu is blank, or if you simply wish to modify your menu,
  366.      press F3 from the Main Menu screen.  The SETUP screen will then be
  367.      displayed.  From this screen you can add or delete headings, write
  368.      or modify the batch files associated with these headings, update
  369.      the menu's colors, change the title of any menu page, enter the
  370.      number of seconds until the screen saver (blanker) is invoked, and
  371.      choose the style of the screen blanker (plain black, or "moth-
  372.      eaten").
  373.  
  374.      For example, let's say that we have a blank menu and that we wish
  375.      to do the following:
  376.  
  377.           1)   Add a heading called "WordPerfect" that runs the word
  378.                processor program and then returns us to MouseMenu
  379.  
  380.           2)   Change all the colors except the selection bar to white
  381.                on black
  382.  
  383.           3)   Create a title for that page--let's call it "MAIN MENU"
  384.  
  385.           4)   Set our screen saver time to 60 seconds
  386.  
  387.           5)   "Turn on" the "Moths" screen saver
  388.  
  389.  
  390.      In order to accomplish all of that we do the following:
  391.  
  392.  
  393.      2.1  Creating Menu Headings and Batch Files
  394.  
  395.      Press F3 from MouseMenu's Main Menu screen.  Notice that the window
  396.      labelled "Headings for Objectives" is highlighted.  This is your
  397.      "active window" and all of your cursor keys (except TAB) will apply
  398.      to this window only.
  399.  
  400.      Move the cursor (using the arrow keys) to the last blank line in
  401.      the list.  (MouseMenu will not let you add a new heading in any
  402.  
  403.  
  404.                                             6
  405.  
  406.  
  407.  
  408.      place other than the END of the list, unless you wish to INSERT it
  409.      in the middle of a list of headings that have already been entered.
  410.      We'll cover this step in a bit.)
  411.  
  412.      Press ENTER.  A fat cursor will pop up inside the selection bar.
  413.      Type in the words "WordPerfect" then press ENTER again.
  414.  
  415.      Press the HOME key to edit the batch file associated with the
  416.      heading "WordPerfect."  The Batch File Editor will appear on the
  417.      screen.  Just type in the batch file you want to execute.  In this
  418.      case, what we want to do is change directories to the WordPerfect
  419.      directory, run the program, then return to MouseMenu.  We write the
  420.      following:
  421.  
  422.      CD C:\WP51
  423.      WP
  424.      CD C:\MOUSEMEN
  425.      MOUSEMEN
  426.  
  427.      The above example assumes that WordPerfect is on the C: drive under
  428.      a directory called WP51 and that MouseMenu is on the C: drive under
  429.      a directory called MOUSEMEN.  (Note:  Instead of the final two
  430.      lines of the batch file above, we could have put "HOME," since this
  431.      is basically what the HOME.BAT file does.)
  432.  
  433.      Now, press the F2 key to save this file and exit.  At this point,
  434.      the Batch File Editor will disappear and the SETUP screen will
  435.      reappear with the new heading in place.
  436.  
  437.      We'll continue with our example in a moment, but while we're in the
  438.      "Headings for Objectives" window, let's look at some more functions
  439.      (If you're following along with the example, skip ahead to the
  440.      section titled "Changing Screen Colors".):
  441.  
  442.  
  443.      2.2  Inserting a New Heading
  444.  
  445.      To insert a new heading in the middle of a list of existing
  446.      headings,enter the HEADINGS FOR OBJECTIVES window, then put the
  447.      cursor where you want the new heading to go and press the INSERT
  448.      key.  A new space will appear in the heading list which may be
  449.      altered using steps 1 in the process described above.
  450.  
  451.      2.3  Deleting a Heading
  452.  
  453.      To delete an existing heading, move the cursor to the heading you
  454.      wish to delete and press the DELETE key.  You will be asked whether
  455.      or not you really want to delete that heading.  If you answer 'Y',
  456.      the heading will be erased.
  457.  
  458.  
  459.                                             7
  460.  
  461.  
  462.  
  463.      2.4  Moving a Heading
  464.  
  465.      To move a heading, put the selection bar on the heading you wish to
  466.      move, then press the "M" key.  Use the arrow keys to move the
  467.      highlighted heading anywhere in the list.  Press ENTER to save the
  468.      new list or ESCAPE to exit.
  469.  
  470.  
  471.      2.5  Creating a New Page
  472.  
  473.      When you have filled up a page, or whenever you wish, you may
  474.      create a new page by pressing the Control and ENTER keys
  475.      simultaneously while in SETUP.  This will insert a blank page AFTER
  476.      the page you are on.  Use the steps described above to fill in the
  477.      page.
  478.  
  479.  
  480.      2.6  Passing Parameters
  481.  
  482.      MouseMenu will also allow you to pass parameters to your programs
  483.      or DOS commands.  Use the process described in the section above,
  484.      titled "Updating the Data File" to enter the Batch File Editor for
  485.      a specific heading.  Enter the DOS command or program name, then,
  486.      keeping the cursor on that line, press F3.  You will be prompted
  487.      for a command line that will be echoed to the screen when this
  488.      option is selected (the default is "Enter Parameter(s):").  You may
  489.      wish to look at the example supplied with the sample MOUSEMEN.DAT
  490.      in this package ("Run a DOS Command").
  491.  
  492.      NOW, let's go on with our example:
  493.  
  494.  
  495.                                             8
  496.  
  497.  
  498.  
  499.      2.7  Changing Screen Colors
  500.  
  501.      Now, press the TAB key once or click the mouse in the "Screen
  502.      Colors" window to make it the active window.  Use the cursor keys
  503.      to move the cursor under the label marked BACKGROUND.  Press ENTER
  504.      (or the +/- keys) to scroll through the choices.  Stop when the
  505.      background inside the window is black and the foreground is NOT
  506.      flashing.  Move the cursor under the FOREGROUND label and press
  507.      ENTER until the FOREGROUND is white.  Repeat this procedure with
  508.      the FRAME, TITLE, and TIME/DATE labels.  When finished, press TAB
  509.      to lock these colors into the menu.  You may also use the mouse to
  510.      click into another active window.  Once you leave the "Screen
  511.      Colors" window, you will see the screen update to your new color
  512.      scheme.
  513.  
  514.      If you ever mess up your color scheme so badly that you don't even
  515.      want to look at the screen any more (and it isn't hard, believe
  516.      me), all you have do to is move the cursor under the label DEFAULT
  517.      COLORS and press ENTER.  If you don't want the default colors but
  518.      would rather have the last set of colors you had, move the cursor
  519.      under the label LAST SAVED and press ENTER.  Any time along the
  520.      way, if you haven't already "set" the colors by hitting the TAB key
  521.      or changing to another window with the mouse, you can get out of
  522.      the color window by hitting escape.  This will exit the "Screen
  523.      Colors" window without any effect on your colors.
  524.  
  525.      2.8  Titling a Page
  526.  
  527.      At this point, you should be in the "Other Items" window.  (If you
  528.      aren't, just press the TAB key or use your mouse until the "Other
  529.      Items" window is highlighted.)  Put the cursor on the space after
  530.      TITLE and press ENTER.  Type in "MAIN MENU" and press ENTER.  The
  531.      new title is now saved.
  532.  
  533.  
  534.      2.9  Changing Screen Saver Time
  535.  
  536.      Move the cursor to the SCREEN SAVER TIME option and press ENTER.
  537.      Use the BACKSPACE key to delete the default time of 180 seconds and
  538.      enter "60" then press ENTER.
  539.  
  540.  
  541.      2.10 Invoking the "Moths" Screen Saver
  542.  
  543.      Move the cursor next to the "MOTHS" - TYPE SCREEN SAVER SELECTED
  544.      option.  If it reads "OFF" then press the ENTER key to turn it ON.
  545.  
  546.      Press ESCAPE to return to the menu screen.  The new headings should
  547.      be in place.  If you wait for more than 60 seconds before touching
  548.      the keyboard or the mouse, the screen will be "eaten up" by multi-
  549.      colored "moths."  If it is, press any key (such as the SPACE BAR)
  550.      and the Main Menu screen will reappear.  (The purpose of the screen
  551.  
  552.  
  553.                                             9
  554.  
  555.  
  556.  
  557.      saver is to blank the screen while the computer is not in use.  The
  558.      number entered in SETUP mode, is the number of seconds MouseMenu
  559.      waits after a key has been pressed before it blanks the screen.)
  560.  
  561.      You may also use the process described in step 1 above to change
  562.      any existing heading.
  563.  
  564.  
  565.      3    Advanced SETUP Information (DAT File Specifics)
  566.  
  567.      If you wish, for some reason, to edit the MouseMen.Dat file with a
  568.      text editor, read thoroughly through this section first.
  569.  
  570.      The DAT file is comprised of text symbols which let MouseMenu know
  571.      exactly what your menu set up is.  The first character of each line
  572.      is a text symbol.  The following table will help you to understand
  573.      just what these symbols are:
  574.  
  575.                        ╔══════════════╤═════════════════╗
  576.                        ║ Text Symbol  │  Symbol Meaning ║
  577.                        ╟──────────────┼─────────────────╢
  578.                        ║     #        │   End of Page   ║
  579.                        ╟──────────────┼─────────────────╢
  580.                        ║     %        │    Page Title   ║
  581.                        ╟──────────────┼─────────────────╢
  582.                        ║     *        │   Heading Name  ║
  583.                        ╟──────────────┼─────────────────╢
  584.                        ║     +        │  Line of Batch  ║
  585.                        ╟──────────────┼─────────────────╢
  586.                        ║     -        │  Line of Batch  ║
  587.                        ║              │  With Parameter ║
  588.                        ╟──────────────┼─────────────────╢
  589.                        ║     !        │    Formatting   ║
  590.                        ╚══════════════╧═════════════════╝
  591.  
  592.      If a "-" symbol appears at the first of a line, it tells MouseMen
  593.      that when the batch file is created, more text should be added on
  594.      that particular line.  (Ex:  the name of a file to be edited when
  595.      you invoke your editor.)  To do this, simply type:
  596.  
  597.      -"Enter File Name:"Editor
  598.  
  599.      This will create a batch file to start Editor.  But, before it does
  600.      so, it will prompt the user with the request "Enter File Name:".
  601.      The prompt for the user will be whatever you put in the double
  602.      quotes.  If no prompt is specified, the default is "Enter
  603.      Parameter(s):"  The text entered will be placed at the end of the
  604.      Batch Line.  This means that if you were to type out the batch file
  605.      (MouseTmp.Bat), it would look like this:
  606.  
  607.  
  608.                                             10
  609.  
  610.  
  611.  
  612.      Editor Filename
  613.  
  614.      If this is confusing, look at the example DAT file included with
  615.      the MouseMenu package.  You can avoid a lot of pain by using the
  616.      MouseMenu batch file editor instead of doing this yourself.
  617.  
  618.      The Formatting symbol "!" lets MouseMenu know what the colors, time
  619.      to screen saver, and other user-selectable options are.  The
  620.      exclamation point is followed by a one or two-letter code, a space,
  621.      and then a number.  Depending on the code, the number can mean a
  622.      color, a time, or a function.  Here is a table which could help you
  623.      understand this better:
  624.  
  625.       ╔═════════════╤═════════════════════════════╤═══════════════════╗
  626.       ║ Format Code │        Code Meaning         │   Number Meaning  ║
  627.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  628.       ║      F      │      Foreground Color       │  Color (0 .. 15)  ║
  629.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  630.       ║      B      │      Background Color       │  Color (0 .. 15)  ║
  631.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  632.       ║      FR     │         Frame Color         │  Color (0 .. 15)  ║
  633.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  634.       ║      FB     │      Foreground of Bar      │  Color (0 .. 15)  ║
  635.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  636.       ║      BB     │      Background of Bar      │  Color (0 .. 15)  ║
  637.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  638.       ║      T      │      Time Display Color     │  Color (0 .. 15)  ║
  639.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  640.       ║      TI     │          Title Color        │  Color (0 .. 15)  ║
  641.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  642.       ║      TO     │   Time Until Screen Blanked │ Number of seconds ║
  643.       ╟─────────────┼─────────────────────────────┼───────────────────╢
  644.       ║      MO     │      "Moths" Screen Saver   │    1=On   0=Off   ║
  645.       ╚═════════════╧═════════════════════════════╧═══════════════════╝
  646.  
  647.      The numbers for the colors are the standard 16 text screen colors,
  648.      as  defined below:
  649.  
  650.           0    =    Black
  651.           1    =    Blue
  652.           2    =    Green
  653.           3    =    Cyan
  654.           4    =    Red
  655.           5    =    Magenta
  656.           6    =    Brown
  657.           7    =    Light Gray
  658.           8    =    Dark Gray
  659.           9    =    Light Blue
  660.           10   =    Light Green
  661.           11   =    Light Cyan
  662.           12   =    Light Red
  663.           13   =    Light Magenta
  664.           14   =    Yellow
  665.           15   =    White
  666.                                             11
  667.  
  668.  
  669.  
  670.      If there are no colors specified, then MouseMenu defaults to the
  671.      following configuration:
  672.  
  673.           F    =    15
  674.           B    =    1
  675.           FR   =    11
  676.           FB   =    0
  677.           BB   =    7
  678.           T    =    10
  679.           TI   =    12
  680.           TO   =    180
  681.           MO   =    0
  682.  
  683.      Once again, it's a lot easier to use the SETUP screen that
  684.      MouseMenu provides, but you can edit the DAT file directly with
  685.      this information.
  686.  
  687.  
  688.      4    Expanding MouseMenu
  689.  
  690.      Since MouseMenu allows the user up to 8 pages of headings, with 16
  691.      headings per page, a maximum of 128 batch files can be accessed by
  692.      a touch of a key or a flick of the mouse.  However, if MouseMenu is
  693.      used on a directory-by-directory basis, the only limit to the
  694.      number of accessible batch files is the amount of free space on the
  695.      disk.
  696.  
  697.      To do this in the most effective and space-saving manner, place
  698.      MOUSERUN.EXE in a pathed directory (such as the root or a utility
  699.      directory - many people create a directory called "MouseMen" which
  700.      they add to their PATH).  Now, MouseMenu may be executed from any
  701.      directory on the disk.  However, MouseMenu looks in the current
  702.      directory for the data file MOUSEMEN.DAT.  The user may therefore
  703.      place a different version of MOUSEMEN.DAT in each directory on the
  704.      disk (different headings, colors, titles, screen saver times,
  705.      etc.).  This is particularly helpful on computers which have
  706.      several users:  each user may have his or her own menus!
  707.  
  708.  
  709.  
  710.      5    Known Problems
  711.  
  712.      Version 2.9.3 of MouseMenu has been thoroughly tested by many users
  713.      and most of the problems found from version 1.0 on have been
  714.      corrected.  However, there are sill a few bugs that have yet to be
  715.      worked out.  First, for some unknown reason, the heading editor in
  716.      SETUP will sometimes cease to work.  If that happens, you'll be
  717.      forced to edit the MouseMen.Dat file with a text editor to change
  718.      the names of your headings.  (Note:  although this problem has been
  719.      reported a couple of times, it is still very rare.)
  720.  
  721.      MouseMenu also takes up a great deal of memory while it is in the
  722.  
  723.  
  724.                                             12
  725.  
  726.  
  727.  
  728.      DOS Shell mode.  Although you can do normal DOS functions (copy,
  729.      delete, format, etc.), and many programs do run fine, some programs
  730.      just won't have enough memory to load, and others will load but
  731.      will lock up your computer.  Be careful running DOS programs in the
  732.      Shell -- don't forget that you are in the shell and run MouseMenu
  733.      again!  MouseMenu is one of the programs that will load even inside
  734.      the DOS shell, but you'll suddenly find that you don't have enough
  735.      memory to do anything.  The DOS shell is very useful, but don't
  736.      overuse it!
  737.  
  738.      If any more problems are discovered, please let me know by mailing
  739.      a letter or a post card to the address listed above, or by E-
  740.      mailing me on Prodigy or America Online.
  741.  
  742.  
  743.      6    Summary
  744.  
  745.      I hope you enjoy using MouseMenu.  I wrote this menu for my own
  746.      personal use and the use of my family and friends.  Most of the
  747.      improvements since version 1.0 (and there have been several) are
  748.      the direct result of input from my friends and family.  I thank all
  749.      of you who helped me by "alpha" and "beta" testing this product for
  750.      so long.
  751.  
  752.      Please use MouseMenu as much as you want.  Let me know if you find
  753.      any new or different uses for it (I've run across several
  754.      interesting uses and would be fascinated to hear others).
  755.  
  756.      MouseMenu!  It's FUN!  HEY, IT'S CHEAP!
  757.                                             13
  758.  
  759.  
  760.  
  761.                                    INDEX
  762.      Subject                                               Page Number
  763.  
  764.      America Online                                              1, 13
  765.  
  766.      Colors                                                5, 6, 9, 11
  767.  
  768.      Default Colors                                              9, 12
  769.  
  770.      Default Prompt (Passing Parameters)                         8, 10
  771.  
  772.      Default time                                                    9
  773.  
  774.      DOS                                                             8
  775.  
  776.      DOS 3.30                                                        2
  777.  
  778.      DOS 3.X                                                         3
  779.  
  780.      DOS Shell                                                   5, 13
  781.  
  782.      Fee                                                          1, 3
  783.  
  784.      FREEWARE                                                        3
  785.  
  786.      HOME.BAT                                                  2, 4, 7
  787.  
  788.      Memory                                                   3, 5, 12
  789.  
  790.      MicroSoft■                                                      1
  791.  
  792.      MOUSEMEN.BAT                                              1, 2, 4
  793.  
  794.      MOUSEMEN.DAT                                      2, 6, 8, 10, 12
  795.  
  796.      MouseMenu 3.0                                                3, 6
  797.  
  798.      MOUSERUN.EXE                                                2, 12
  799.  
  800.      MouseTmp.Bat                                                4, 10
  801.  
  802.      Prodigy                                                     1, 13
  803.  
  804.      Registration                                                  1-3
  805.  
  806.      Requirements                                                    3
  807.  
  808.      Screen saver                                      5, 6, 9, 11, 12
  809.  
  810.      SHAREWARE                                                     1-3
  811.  
  812.      Upgrades                                                        3
  813.  
  814.                                            14
  815.  
  816.  
  817.  
  818.  
  819. ----------------------- PLEASE PRINT CLEARLY ------------------------
  820.  
  821.  
  822. David R. Webb                | NAME:    _____________________________
  823. P.O. Box 17                  |
  824. Kaysville, UT    84037-0017  | ADDRESS: _____________________________
  825.                              |
  826.                              | CITY:     ____________________________
  827.                              |
  828.                              | STATE:    _____________ ZIP: _________
  829.                              |
  830.                              | Phone:    (     ) ____________________
  831.  
  832.  
  833. PROGRAM USERS:
  834.  
  835. Quantity of Users:  ______ X $5.00/User = Amount Enclosed:  _________
  836.  
  837. VERSION OF MOUSEMENU:
  838. (Press F2 from the main screen.)
  839.  
  840. If you do not have the most current release of MouseMenu, it will be
  841. sent to you.  Please, let me know what disk size to use (all disks
  842. are low density).
  843.  
  844. Version Number:     ________________     Floppy Disk Size: __________
  845.  
  846.  
  847. FOREIGN PAYMENT: All payments must be in U.S. Dollars drawn on a U.S.
  848.                  Bank.
  849.  
  850. PAYMENT: Send Check or Money Orders ONLY.  Personal CHECKS require 10
  851.          working days to clear the bank before your order is shipped.
  852.  
  853.